home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / races26.zip / RACES.DOC < prev    next >
Text File  |  1992-11-08  |  12KB  |  286 lines
  1.  
  2.                                    RACES 2.6
  3.                                    =========
  4.  
  5.                             A Livewire BBS Game Door
  6.                                PCBoard(TM) 14.5 
  7.  
  8.                                       By
  9.  
  10.                                 Richard Paquette
  11.                                    PO Box 416
  12.                               Mt. Laurel, NJ 08054
  13.  
  14.                                (C) Copyright 1990
  15.                                All Rights Reserved
  16.  
  17.  
  18.                  GAME DESCRIPTION!
  19.  
  20.     This is a quick and simple game that allows your callers to enter a bet
  21. on the horse they think will win the race. When placing the bet, we generate a
  22. random odds for the winning horse which is displayed along with a chance to 
  23. change their bet. As soon as they finish entering their bet they are brought to
  24. the Horse Menu at which time they pick which Horse they think will win.
  25.  
  26.     The race itself will take approx. 13 seconds at 2400 baud, faster with
  27. high speed modems, my dual standard finished the race in about 6 seconds. As
  28. the race finishes, they are brought either to the " Winners Circle " where the
  29. winning amount is displayed along with their current score, or they go to the
  30. " Losers Box " where they are shown how much they lost along with their current
  31. score.
  32.  
  33.     From the Main Menu, they can go straight to the races, which will use
  34. $2.00 default for their bet. They can also view their current balance or they
  35. can view current high scores. Last they can return to the BBS.
  36.  
  37.     In future updates, we plan to add betting on "Win", "Place" and "Show"
  38. along with more Horse selections, currently there are Five Horses to select
  39. from and each race is randomly won!
  40.  
  41.     PLEASE NOTE FOR SYSOP! Once you install the door, you should enter it
  42. and exist to create the High Score Bulletin, then if you would like to keep
  43. your score at $100.00 just don't play! If you play, then whatever your current
  44. score is when you exit, will show on the first High Score Bulletin! Personally,
  45. I lost all my money so callers wouldn't think that "sysops" have the advantage!
  46.  
  47.                 BULLETIN INFORMATION
  48.  
  49.     AFTER you initiate the High Score Bulletin, the program will create a
  50. file called " Races.bul ", if you want to name your bulletin other than
  51. races.blt and racesg.blt then you must edit the first line in races.bul to
  52. state the path and name of your desired bulletin, such as:
  53.  
  54. c:\pcb\gen\blt1
  55.  
  56. CONFIGURATION
  57. -------------
  58.  
  59. All registration numbers go on line 5, these are the sample first 4 lines for
  60. about any bbs software you might be running... let us know if you have any kind
  61. of problem..
  62.  
  63. EXAMPLE CONFIGURATION FILE FOR PCBOARD.SYS
  64. ------------------------------------------
  65.  
  66.         C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  67.         The Livewire BBS    <=-  (Change this to your BBS name)
  68.         Richard             <=-  (The Sysop's first name)
  69.         Paquette            <=-  (The Sysop's last name)
  70.         999999              <=-  (Registration number)
  71.  
  72.         EXAMPLE CONFIGURATION FILE FOR USERS.SYS
  73.         ------------------------------------------
  74.  
  75.         C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  76.         The Livewire BBS    <=-  (Change this to your BBS name)
  77.         Richard             <=-  (The Sysop's first name)
  78.         Paquette            <=-  (The Sysop's last name)
  79.         999999              <=-  (Registration Number)
  80.  
  81.         EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
  82.         ---------------------------------------
  83.  
  84.         C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  85.         The Livewire BBS    <=-  (Change this to your BBS name)
  86.         Richard             <=-  (The Sysop's first name)
  87.         Paquette            <=-  (The Sysop's last name)
  88.         999999              <=-  (Registration Number)
  89.  
  90.         EXAMPLE CONFIGURATION FILE FOR NEW WILDCAT
  91.         ------------------------------------------
  92.  
  93.         C:\CAT\USERINFO.DAT <=- (Full pathnam of your USERINFO.DAT file)
  94.         The Livewire BBS    <=- (Change this to your BBS name)
  95.         Richard             <=- (The Sysop's first name)
  96.         Paquette            <=- (The Sysop's last name)
  97.                
  98.         EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
  99.         -------------------------------------------
  100.  
  101.         C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  102.         The Livewire BBS    <=-  (Change this to your BBS name)
  103.         Richard             <=-  (The Sysop's first name)
  104.         Paquette            <=-  (The Sysop's last name)
  105.  
  106.         EXAMPLE CONFIGURATION FILE FOR DORINFOx.DEF
  107.         -------------------------------------------
  108.  
  109.         C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  110.                                   where 'x' is the BBS Node number.
  111.         The Livewire BBS    <=-  (Change this to your BBS name)
  112.         Richard             <=-  (The Sysop's first name)
  113.         Paquette            <=-  (The Sysop's last name)
  114.  
  115.         EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
  116.         ------------------------------------------
  117.  
  118.         C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  119.         The Livewire BBS    <=-  (Change this to your BBS name)
  120.         Richard             <=-  (The Sysop's first name)
  121.         Paquette            <=-  (The Sysop's last name)
  122.  
  123.         EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
  124.         ----------------------------------------
  125.  
  126.         C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  127.         The Livewire BBS    <=-  (Change this to your BBS name)
  128.         Richard             <=-  (The Sysop's first name)
  129.         Paquette            <=-  (The Sysop's last name)
  130.  
  131.         This configuration file must be located in your default BBS
  132.         directory.  You may name this file whatever you like, but the
  133.         name of the file must be passed to RACES via the Batch file
  134.         that executes the door.
  135.  
  136.                                 RACES BATCH FILE
  137.  
  138. This is the batch file whose name is entered in PCBSETUP. It should reside in
  139. your default PCB directory. Leave this as is except for changing the paths.
  140.  
  141.          ECHO OFF
  142.          E:
  143.          CD\RACES
  144.          RACES RACES.CFG  <--- Please read NOTE below
  145.          C:
  146.          CD\PCB
  147.          BOARD
  148.  
  149. IMPORTANT NOTE FOR DIGIBOARD USERS:
  150.  
  151.  Races now includes support for FOSSIL drivers!!! This means your Doors
  152.  will work with Digiboard (e.g. Wildcat!'s M version) and other multi-port
  153.  boards. To activate the Fossil driver support, just include /FD on the
  154.  command line when running the Door. For example:
  155.  
  156.       RACES RACES.CFG /FD
  157.  
  158.  If no Fossil driver is available, Races will display a message to that
  159.  effect and exit gracefully.
  160.  
  161. IMPORTANT NOTE FOR NON STANDARD IRQ's:
  162.  
  163.                   Supports COM 1 to 4 on the standard IRQ's
  164.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  165.  
  166.                You can make use of the IRQ environment variable
  167.  
  168.     If you wish to use a non-standard IRQ, add the IRQ number after the 
  169. configuration filename. For example the program is STORE and you want to use 
  170. Com1 and IRQ5. The command line passed to your door would be:
  171.  
  172.                             STORE STORE.CFG /5 
  173.                                    or
  174.              STORE STORE.CFG /%IRQ% using the environment variable
  175.  
  176.     The /5 tells STORE to use IRQ5 rather than the standard IRQ4 that is
  177. normally used with COM1. No /x parameter is needed for the standard IRQ's.
  178.  
  179.    You can also make use of the PCBoard environment variables such as:
  180.  PCBDRIVE and PCBDIR. Or you can use your own for example, let's say that
  181.  your system runs on D: drive and your system directory is call GAP then
  182.  you could use the variables at the start of your batch file such as:
  183.  
  184.    d:\
  185.    cd\doors\facts
  186.    set pcbdrive=d:
  187.    set pcbdir=\gap
  188.    facts facts.cfg
  189.    d:\
  190.    cd\gap
  191.    gap
  192.  
  193.  Then the first line in your cfg would look like this:
  194.  
  195.                      %PCBDRIVE%%PCBDIR\dorinfo.def
  196.  
  197.    NOTE: If your caller is in NON-GRAPHIC mode, the door will put the caller
  198.          into graphics and return them to non graphics when existing!
  199.  
  200.                      ------------------------------------
  201.  
  202.                                 DOOR OPERATION
  203.                                 --------------
  204.   
  205.   F3    -   Toggles the printer On/Off.
  206.             Value is passed to PCBoard.
  207.   F4    -   Toggles the Page Bell On/Off.
  208.             Value is passed to PCBoard.
  209.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  210.   F7    -   Toggles the Caller Alarm On/Off.
  211.             Value is passed to PCBoard.
  212.   F8    -   Returns the caller involuntarily to PCBoard.
  213.             Without letting them know that the sysop called them back!
  214.   F9    -   Toggles the local display On/Off.
  215.             Value is passed to PCBoard.
  216.   F10   -   Activates SysOp CHAT mode within the DOOR.
  217.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  218.   HOME  -   HELP key for status line options.
  219.   UP    -   Allows the SysOp to temporarily give the caller extra time
  220.             while in the DOOR.  This time is NOT passed to PCBoard.
  221.   DN    -   Allows the SysOp to temporarily subtract time from the
  222.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  223.   ALT-N -   SysOp next on toggle.
  224.             Value is passed to PCBoard.
  225.   ALT-X -   PCBoard will exit after current caller logs off.
  226.             Value is passed to PCBoard.
  227.  
  228.                             WATCHDOG/CTTY/ANSI.SYS
  229.                             ----------------------
  230.  
  231.         CTTY and WATCHDOG are not required and should not be used with
  232.         this program.  RACES contains its own communication routines
  233.         which monitor the COM port.  If carrier is lost, it will return
  234.         to PCBoard where the BBS will log the user off the system.
  235.         ANSI.SYS, or something similar, is required for RACES to
  236.         function properly!
  237.  
  238.  
  239.                                  DISTRIBUTION
  240.                                  ------------
  241.  
  242.         RACES is COPYRIGHTED by Richard Paquette, with all rights reserved.
  243.         This program is being distributed via the SHAREWARE concept and as
  244.         such, may be copied freely with the following restrictions:
  245.  
  246.                 * The program must be supplied in it's original
  247.                   unmodified form, including documentation.
  248.  
  249.                 * RACES may not be distributed as part of any
  250.                   commercial application or service without the
  251.                   express, written consent of the author.
  252.  
  253.                 * Vendors of Shareware/Public Domain software may
  254.                   not distribute this program without the express,
  255.                   written consent of the author.
  256.  
  257.                                  REGISTRATION
  258.                                  ------------
  259.  
  260.         RACES represents many hours of programming and the author
  261.         deserves just compensation for his time, efforts and expertise.
  262.         If you find this program to be of some value and you continue
  263.         to use it on your BBS system, you must return the registration
  264.         form provided along with the registration fee. Registration
  265.         entitles you to free upgrades via modem from The Livewire's Support
  266.         Conference for a period of one year.
  267.  
  268.         Payments should be made in the form of a check or money order 
  269.         (do NOT send cash!). Foreign orders must be in U.S. funds drawn 
  270.         on a U.S. bank. 
  271.         
  272.         You may also call The Livewire BBS and register online via Visa 
  273.         or Mastercard by typing REGISTER at the Main Board.
  274.  
  275.         Suggestions and/or comments may be sent to the address below or
  276.         via electronic mail: 
  277.  
  278.                   HUBSNJ for RelayNet and Node ID is: LIVEWIRE
  279.  
  280.                                  Richard Paquette
  281.                                  The Livewire BBS     
  282.  
  283.                Public Node:  (609) 235-5297 MNP/5 - 300/1200/2400
  284.                  Access to all Nodes after a door registration.
  285.                             ----------------------
  286.